home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / psjava10.zip / PortScan.txt < prev    next >
Text File  |  1997-08-09  |  6KB  |  196 lines
  1. -----------TCP PortScan for Java v1.0------------
  2.  
  3.           Written by Eduardo Fernandez
  4. -------------------------------------------------
  5.  
  6. DISCLAIMER: By using this program you acknowledge
  7. that Eduardo Fernandez is not responsible for ANY
  8. damage casued by its use.
  9.  
  10. -------------------------------------------------
  11.  
  12. 1.0 INTRODUCTION
  13.  
  14.           -----------------------------
  15.  
  16.     1.1 Contents
  17.  
  18. DISCLAIMER .................................. 0.0
  19.  
  20. INTRODUCTION ................................ 1.0
  21. Contents .................................... 1.1
  22. About The Author ............................ 1.2
  23. About The Product ........................... 1.3
  24.  
  25. USAGE ....................................... 2.0
  26. Running PortScan ............................ 2.1
  27. Scanning A Computer ......................... 2.2
  28. Win Nukeing a Computer ...................... 2.3
  29. Updating the Services File .................. 2.4
  30.  
  31. HOW TO CONTACT .............................. 3.0
  32. Reporting a Bug ............................. 3.1
  33. Suggesting a Feature ........................ 3.2
  34. Other Stuff ................................. 3.3
  35.  
  36. BUGS AND COMPATIBILITY ...................... 4.0
  37. Known Bugs .................................. 4.1
  38. Tested JDKs ................................. 4.2
  39.  
  40.           -----------------------------
  41.  
  42.     1.2 About The Author
  43.  
  44.      Eduardo Fernandez is a Computer Engineering
  45. major at the University of Florida. He is
  46. scheduled to graduate in May 1998 so hire him
  47. quick! In addition to TCP PortScan for Java,
  48. he is authoring Scramble, a Java based game.
  49.  
  50.           -----------------------------
  51.  
  52.     1.3 About The Product
  53.  
  54.      TCP PortScan is a freeware port scanner
  55. written completely in Java. No J/Direct no
  56. native calls anywhere.
  57.      Freeware does not mean leftrighted. This
  58. software and all classed contained in the zip
  59. are copyrighted property of Eduardo
  60. Fernandez. Any unauthorized modification of this
  61. program without the expressed written consent
  62. of Eduardo Fernandez is forbidden. So don't
  63. do it.
  64.  
  65. -------------------------------------------------
  66.  
  67. 2.0 USAGE
  68.  
  69.           -----------------------------
  70.  
  71.     2.1 Running PortScan
  72.  
  73.      In order to use TCP PortScan for Java you
  74. must have a Java JDK or JRE. Tested JDKs are
  75. listed in section 4.2.
  76.      Prior to running PortScan ensure that ./.
  77. or .\. are in your CLASSPATH. If it is not it
  78. will not be able to load up the provided services
  79. file.
  80.      To run simply type: JAVA PortScan
  81.         from a command prompt.
  82.      In order to run without the console on Windows
  83.         use JAVAW PortScan
  84.         and under OS/2 use JAVAPM PortScan
  85.  
  86.           -----------------------------
  87.  
  88.     2.2 Scanning A Computer
  89.  
  90.      Once PortScan is loaded in order to scan a
  91. computer simply type in the target address in the
  92. top text box.
  93.      Once you have entered that you may select the
  94. range to scan. By default it is 1-512.
  95.      Then to scan click the "Begin Scan" button.
  96.      The program will then spawn threads to scan the
  97. ports. As responses arrive they will be added in the
  98. list box on the right, and provided the services
  99. file loaded, the port description will appear.
  100.  
  101.           -----------------------------
  102.  
  103.     2.3 Win Nuking A Computer
  104.  
  105.      PortScan has a feature called Win Nuke. This
  106. feature exploits a bug in the Winsock TCP/IP stack
  107. which allows an OOB/NoDelay packet to crash the
  108. system the packet is sent to. These packets are
  109. sent through port 139. Microsoft has issued a patch
  110. to prevent these attacks.
  111.      To use it, enter the Target Address in the
  112. text field, then click Win Nuke.
  113.      This can be done during a scan as well.
  114.  
  115.      NOTE!: Use this feature at your own risk! I
  116. am not responsible for the consequences. Some ISPs
  117. do not appreciate their customers being nuked.
  118.  
  119.           -----------------------------
  120.  
  121.     2.4 Updating The Services File
  122.  
  123.      The services file is the file from which
  124. PortScan gets the port descriptions. The services
  125. file shipped with PortScan contains over 1300
  126. services. You may add services simply by editing
  127. the file and adding them. You may also replace the
  128. file entirely with your own so long as the format
  129. is substantially the same.
  130.  
  131.      NOTE!: The distributed services file is
  132. has UDP ports removed since TCP PortScan only does
  133. TCP ports.
  134.  
  135. -------------------------------------------------
  136.  
  137. 3.0 HOW TO CONTACT
  138.  
  139.           -----------------------------
  140.  
  141.     3.1 Reporting a Bug
  142.  
  143.      To report a bug, please email me at
  144. eduardof@grove.ufl.edu with the subject line
  145. "PortScan BUG"
  146.  
  147.           -----------------------------
  148.  
  149.     3.2 Suggesting a Feature
  150.  
  151.      To suggest a feature, please email me at
  152. eduardof@grove.ufl.edu with the subject line
  153. "PortScan SUGGESTION"
  154.  
  155.           -----------------------------
  156.  
  157.     3.3 Other Stuff
  158.  
  159.      All updates will be available off of
  160. http://www.gdn.net/~beer/portscan.html
  161.  
  162.      If you want to contact me about something
  163. else feel free to email me at
  164. eduardof@grove.ufl.edu
  165.  
  166. -------------------------------------------------
  167.  
  168. 4.0 BUGS AND COMPATIBILITY
  169.  
  170.           -----------------------------
  171.  
  172.     4.1 Known Bugs
  173.  
  174.      - Upon canceling a scan, the threads are not
  175.           killed instantly. This is because they
  176.           are blocked. They do die immediatly after
  177.           the unblock.
  178.  
  179.           -----------------------------
  180.  
  181.     4.2 Tested JDKs
  182.  
  183.      Linux: 1.1.3 JDK
  184.  
  185.      OS/2: IBM VAJava 1.0
  186.            IBM 1.1.1 JDK
  187.  
  188.      Windows95: Sun's JRE 1.1.3
  189.                 Sun's JDK 1.1.3
  190.  
  191. -------------------------------------------------
  192. Copyright 1997 Eduardo Fernandez
  193.  
  194. All trademarks rights are held by their respective
  195. trademark holders.
  196.